home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / gcc / gcc260utilsdoc.lha / gnu / man / man1 / ls.1 < prev    next >
Encoding:
Text File  |  1994-07-26  |  9.3 KB  |  265 lines
  1.  
  2.  
  3.  
  4. LS(1L)            Misc. Reference Manual Pages             LS(1L)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ls, dir, vdir - list contents of directories
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      llllssss [-abcdfgiklmnpqrstuxABCFGLNQRSUX1] [-w cols] [-T cols] [-
  13.      I  pattern]  [ --all] [--escape] [--directory] [--inode] [--
  14.      kilobytes] [ - - numeric-uid-gid]  [--no-group]  [ - - hide-
  15.      control-chars]  [ - - reverse]  [ --size] [--width=cols] [--
  16.      tabsize=cols] [--almost-all] [--ignore-backups] [--classify]
  17.      [ - -file-type] [--full-time] [--ignore=pattern] [--derefer-
  18.      ence] [--literal] [ - - quote-name]  [ - - recursive]  [ - -
  19.      sort={none,time,size,extension}]         [        -        -
  20.      format={long,verbose,commas,across,vertical,single-column}]
  21.      [ - - time={atime,access,use,ctime,status}] [--help] [--ver-
  22.      sion] [path...]
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      This manual page documents the GNU version of llllssss.   ddddiiiirrrr  and
  26.      vvvvddddiiiirrrr  are  versions of llllssss with different default output for-
  27.      mats.  These programs list  each  given  file  or  directory
  28.      path.   Directory  contents  are sorted alphabetically.  For
  29.      llllssss, files are by default listed in  columns,  sorted  verti-
  30.      cally,  if the standard output is a terminal; otherwise they
  31.      are listed one per line.  For  ddddiiiirrrr,  files  are  by  default
  32.      listed  in  columns, sorted vertically.  For vvvvddddiiiirrrr, files are
  33.      by default listed in long format.
  34.  
  35.   OOOOPPPPTTTTIIIIOOOONNNNSSSS
  36.      -_a, --_a_l_l
  37.           List all files in directories, including all files that
  38.           start with `.'.
  39.  
  40.      -_b, --_e_s_c_a_p_e
  41.           Quote nongraphic characters in file names using  alpha-
  42.           betic  and octal backslash sequences like those used in
  43.           C.
  44.  
  45.      -_c, --_t_i_m_e=_c_t_i_m_e, --_t_i_m_e=_s_t_a_t_u_s
  46.           Sort directory contents according to the files'  status
  47.           change  time  instead of the modification time.  If the
  48.           long listing format is being  used,  print  the  status
  49.           change time instead of the modification time.
  50.  
  51.      -_d, --_d_i_r_e_c_t_o_r_y
  52.           List directories like other files, rather than  listing
  53.           their contents.
  54.  
  55.      -_f    Do not sort directory contents; list them in  whatever
  56.           order  they  are  stored on the disk.  The same as ena-
  57.           bling -_a and -_U and disabling -_l, -_s, and -_t.
  58.  
  59.      --_f_u_l_l-_t_i_m_e
  60.  
  61.  
  62.  
  63. FSF              Last change: GNU File Utilities                1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LS(1L)            Misc. Reference Manual Pages             LS(1L)
  71.  
  72.  
  73.  
  74.           List times in full,  rather  than  using  the  standard
  75.           abbreviation heuristics.
  76.  
  77.      -_g    Ignored; for Unix compatibility.
  78.  
  79.      -_i, --_i_n_o_d_e
  80.           Print the index number of each file to the left of  the
  81.           file name.
  82.  
  83.      -_k, --_k_i_l_o_b_y_t_e_s
  84.           If file sizes are being listed,  print  them  in  kilo-
  85.           bytes.    This   overrides   the  environment  variable
  86.           POSIXLY_CORRECT.
  87.  
  88.      -_l, --_f_o_r_m_a_t=_l_o_n_g, --_f_o_r_m_a_t=_v_e_r_b_o_s_e
  89.           In addition to the name of each file,  print  the  file
  90.           type,  permissions,  number  of hard links, owner name,
  91.           group name, size in bytes, and timestamp (the modifica-
  92.           tion  time unless other times are selected).  For files
  93.           with a time that is more than 6 months old or more than
  94.           1 hour into the future, the timestamp contains the year
  95.           instead of the time of day.
  96.  
  97.      -_m, --_f_o_r_m_a_t=_c_o_m_m_a_s
  98.           List files horizontally, with as many as  will  fit  on
  99.           each line, separated by commas.
  100.  
  101.      -_n, --_n_u_m_e_r_i_c-_u_i_d-_g_i_d
  102.           List the numeric UID and GID instead of the names.
  103.  
  104.      -_p    Append a character to each file  name  indicating  the
  105.           file type.
  106.  
  107.      -_q, --_h_i_d_e-_c_o_n_t_r_o_l-_c_h_a_r_s
  108.           Print question marks instead of  nongraphic  characters
  109.           in file names.
  110.  
  111.      -_r, --_r_e_v_e_r_s_e
  112.           Sort directory contents in reverse order.
  113.  
  114.      -_s, --_s_i_z_e
  115.           Print the size of each file in 1K blocks to the left of
  116.           the   file   name.    If   the   environment   variable
  117.           POSIXLY_CORRECT  is  set,  512-byte  blocks  are   used
  118.           instead.
  119.  
  120.      -_t, --_s_o_r_t=_t_i_m_e
  121.           Sort directory contents by timestamp instead of  alpha-
  122.           betically, with the newest files listed first.
  123.  
  124.      -_u, --_t_i_m_e=_a_t_i_m_e, --_t_i_m_e=_a_c_c_e_s_s, --_t_i_m_e=_u_s_e
  125.           Sort directory contents according to  the  files'  last
  126.  
  127.  
  128.  
  129. FSF              Last change: GNU File Utilities                2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LS(1L)            Misc. Reference Manual Pages             LS(1L)
  137.  
  138.  
  139.  
  140.           access  time  instead of the modification time.  If the
  141.           long listing format  is  being  used,  print  the  last
  142.           access time instead of the modification time.
  143.  
  144.      -_x, --_f_o_r_m_a_t=_a_c_r_o_s_s, --_f_o_r_m_a_t=_h_o_r_i_z_o_n_t_a_l
  145.           List the files in columns, sorted horizontally.
  146.  
  147.      -_A, --_a_l_m_o_s_t-_a_l_l
  148.           List all files in directories, except for `.' and `..'.
  149.  
  150.      -_B, --_i_g_n_o_r_e-_b_a_c_k_u_p_s
  151.           Do not list files that end with `~',  unless  they  are
  152.           given on the command line.
  153.  
  154.      -_C, --_f_o_r_m_a_t=_v_e_r_t_i_c_a_l
  155.           List files in columns, sorted vertically.
  156.  
  157.      -_F, --_c_l_a_s_s_i_f_y
  158.           Append a character to each  file  name  indicating  the
  159.           file  type.   For  regular  files  that are executable,
  160.           append a `*'.  The file type  indicators  are  `/'  for
  161.           directories, `@' for symbolic links, `|' for FIFOs, `='
  162.           for sockets, and nothing for regular files.
  163.  
  164.      -_G, --_n_o-_g_r_o_u_p
  165.           Inhibit display of group information in a  long  format
  166.           directory listing.
  167.  
  168.      -_L, --_d_e_r_e_f_e_r_e_n_c_e
  169.           List the files linked to by symbolic links  instead  of
  170.           listing the contents of the links.
  171.  
  172.      -_N, --_l_i_t_e_r_a_l
  173.           Do not quote file names.
  174.  
  175.      -_Q, --_q_u_o_t_e-_n_a_m_e
  176.           Enclose file names in  double  quotes  and  quote  non-
  177.           graphic characters as in C.
  178.  
  179.      -_R, --_r_e_c_u_r_s_i_v_e
  180.           List the contents of all directories recursively.
  181.  
  182.      -_S, --_s_o_r_t=_s_i_z_e
  183.           Sort directory contents by file size instead of  alpha-
  184.           betically, with the largest files listed first.
  185.  
  186.      -_U, --_s_o_r_t=_n_o_n_e
  187.           Do not sort directory contents; list them  in  whatever
  188.           order  they are stored on the disk.  This option is not
  189.           called -_f because the Unix llllssss -_f option also enables -_a
  190.           and disables -_l, -_s, and -_t.  It seems useless and ugly
  191.           to group those unrelated things together in one option.
  192.  
  193.  
  194.  
  195. FSF              Last change: GNU File Utilities                3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LS(1L)            Misc. Reference Manual Pages             LS(1L)
  203.  
  204.  
  205.  
  206.           Since  this  option doesn't do that, it has a different
  207.           name.
  208.  
  209.      -_X, --_s_o_r_t=_e_x_t_e_n_s_i_o_n
  210.           Sort directory contents alphabetically by  file  exten-
  211.           sion  (characters  after  the  last `.'); files with no
  212.           extension are sorted first.
  213.  
  214.      -_1, --_f_o_r_m_a_t=_s_i_n_g_l_e-_c_o_l_u_m_n
  215.           List one file per line.
  216.  
  217.      -_w, --_w_i_d_t_h _c_o_l_s
  218.           Assume the screen is _c_o_l_s columns wide.  The default is
  219.           taken  from  the terminal driver if possible; otherwise
  220.           the environment variable CCCCOOOOLLLLUUUUMMMMNNNNSSSS is used if it is  set;
  221.           otherwise the default is 80.
  222.  
  223.      -_T, --_t_a_b_s_i_z_e _c_o_l_s
  224.           Assume that each tabstop is  _c_o_l_s  columns  wide.   The
  225.           default is 8.
  226.  
  227.      -_I, --_i_g_n_o_r_e _p_a_t_t_e_r_n
  228.           Do not list files whose names match the  shell  pattern
  229.           _p_a_t_t_e_r_n  unless they are given on the command line.  As
  230.           in the shell, an initial `.' in  a  filename  does  not
  231.           match a wildcard at the start of _p_a_t_t_e_r_n.
  232.  
  233.      --_h_e_l_p
  234.           Print a usage message on standard output and exit  suc-
  235.           cessfully.
  236.  
  237.      --_v_e_r_s_i_o_n
  238.           Print version information on standard output then  exit
  239.           successfully.
  240.  
  241. BBBBUUUUGGGGSSSS
  242.      On BSD systems, the -_s option reports sizes  that  are  half
  243.      the correct values for files that are NFS-mounted from HP-UX
  244.      systems.  On HP-UX systems, it reports sizes that are  twice
  245.      the  correct  values for files that are NFS-mounted from BSD
  246.      systems.  This is due to a flaw in HP-UX;  it  also  affects
  247.      the HP-UX llllssss program.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. FSF              Last change: GNU File Utilities                4
  262.  
  263.  
  264.  
  265.